Skip to content

Give Codex its own MCP file so Claude's directory accepts the plugin - #5

Merged
olihou merged 1 commit into
mainfrom
oli/claude-directory-mcp-fields
Nov 13, 2026
Merged

olihou merged 1 commit into
mainfrom
oli/claude-directory-mcp-fields

Conversation

@olihou

@olihou olihou commented Nov 13, 2026

Copy link
Copy Markdown
Collaborator

Why

Anthropic's directory refused 1.0.2 (security scan and validation passed; the directory policy check failed):

Config file fields outside the allowed list accepted only from Verified organizations. […] A remote MCP server's entry can have type, url, headers, timeout, alwaysLoad, oauth on an http or sse server, and name, title, displayName, or description as text. oauth can have clientId, callbackPort, authServerMetadataUrl, and scopes.

The flagged field is mcpServers.nutrient.scopes, the top-level array that #2 added for Codex.

Moving it under oauth.scopes would pass Anthropic but break Codex. Codex's plugin parser (codex-rs/codex-mcp/src/plugin_config.rs) maps only callbackUrl, callbackPort, clientId and clientSecret under oauth, and its OAuth config has no scopes field. Codex would go back to asking for every scope, and every tool call would fail again.

What

  • .mcp.json (Claude): only type and url. Claude Code already takes mcp:invoke offline_access from the service's sign-in challenge.
  • .codex-plugin/mcp.json (new, Codex): today's .mcp.json, top-level scopes included. .codex-plugin/plugin.json points mcpServers at it.
  • .claude-plugin/plugin.json: adds privacyPolicyUrl, which the directory listed as a non-blocking finding.
  • ci/check.py:
    • checks both MCP files declare the one server;
    • fails on any .mcp.json server field or oauth key outside the directory's list;
    • checks the scopes in Codex's file.
  • ci/package_openai.py: requires .codex-plugin/mcp.json. The ZIP still carries .mcp.json too, in case OpenAI's dashboard reads the default path.
  • AGENTS.md and README: describe the split and why.
  • Version 1.0.3 in both manifests and the Claude marketplace entry.

Verified

  • python3 ci/check.py: pass.

  • claude plugin validate ./plugins/nutrient --profile directory --strict: "found nothing to report". The privacy-policy note is gone. claude plugin validate . --strict also passes.

  • Each new guard fails when its rule is broken:

    • scopes back on Claude's server;
    • an oauth.clientSecret;
    • a null oauth;
    • Codex's file without scopes;
    • Codex's manifest pointing back at .mcp.json.

    An allowed oauth.scopes passes.

  • Codex 0.169.0 with an empty CODEX_HOME: codex plugin marketplace add . and codex plugin add nutrient@nutrient install 1.0.3, and codex mcp list shows the server. Giving the two files different URLs showed that Codex reads .codex-plugin/mcp.json, not .mcp.json.

  • python3 ci/package_openai.py builds dist/nutrient-openai-1.0.3.zip.

Not verified

  • ChatGPT: I haven't tried reading the new path from an uploaded ZIP. The 1.0.2 ZIP in OpenAI's review is unaffected. Test an upload before the next OpenAI release.
  • Anthropic's policy check: it only runs in the portal. After merge, the push webhook should start a new check; if not, use "Check for new commits".

🤖 Generated with Claude Code

Anthropic's directory refused 1.0.2 with "Config file fields outside the
allowed list accepted only from Verified organizations". Its list for a
remote server in .mcp.json is type, url, headers, timeout, alwaysLoad,
oauth and text fields, with scopes allowed only under oauth. The top-level
scopes that Codex needs broke that rule.

Moving them under oauth would fix Claude and break Codex: its plugin
parser doesn't read oauth.scopes, so it would ask for every scope again
and every tool call would fail. Codex now reads .codex-plugin/mcp.json,
which keeps the top-level scopes, and .mcp.json has only type and url.
Claude Code already takes the same scopes from the service's sign-in
challenge.

ci/check.py now fails on any .mcp.json field outside the directory's
list, and checks the scopes in Codex's file. plugin.json gets
privacyPolicyUrl, which the directory asked for. Version 1.0.3.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@olihou
olihou merged commit 51c7061 into main Nov 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant